Interactive Systems Showcase Demo
Welcome to the Neptune.js v3.4.0 comprehensive systems showcase. This playable interactive experience exercises all 18 core architectural modules implemented across the engine, demonstrating their real-time cohesion in an action-RPG environment.
Play the Live Showcase Demo
You can interact directly with the embedded runtime demo below, or open it in a dedicated window via Open Fullscreen Demo.
Showcase Subsystems Overview
1. Cellular Automaton Simulation & Material Registry (SIM-01, SIM-02)
MaterialRegistry: Defines physical states (SOLID,LIQUID,GAS,PLASMA), densities, flammability, thermal conductivity, and custom interaction reactions (combustion, extinguish, dissolve).CellGridSimulation: 2D cellular automaton grid supporting thermodynamic heat transfer, fire propagation across flammable wood cells, fluid horizontal water leveling, falling sand gravity, and rising steam vapors.- Interactive Controls: Paint wood barricades, ignite fires, pour water, or cast abilities directly into simulation cells.
2. AI Perception & Bounded Knowledge Memory (AI-01)
PerceptionSystem: Evaluates conical field-of-view (FOV) vision checks (radius, aperture angle, facing orientation, wall occlusions) and acoustic hearing radiuses.NPCKnowledge&BoundedMemory: Records discrete player observation events with capacity limits and temporal recency decay scoring.- Interactive Controls: Adjust FOV sliders in real-time, test noise pulses with abilities or footsteps, and observe NPC awareness states.
3. Utility AI Decision Engine (AI-02)
UtilityAI: Evaluates candidate actions (Patrol,Attack,Flee,Heal) against game contexts using multi-factor considerations and continuous response curves.- Decision Traces: Real-time evaluation logging with deterministic priority tie-breaking.
- Interactive Controls: Inspect live action scores in the sidebar inspector box and watch NPC behavior transition dynamically as health and distance vary.
4. 24-Hour Schedule System & Faction Registry (AI-03)
NPCSchedule&ScheduleSystem: Coordinates daily NPC activity cycles across scheduled time slots (PATROL,GUARD,TAVERN,REST).FactionRegistry: Manages faction relationships, dispositions (FRIENDLY,NEUTRAL,HOSTILE), and reputation scores.- Interactive Controls: Scrub the 24-hour world clock slider and toggle guard disposition between Friendly and Hostile.
5. A* Navigation Grid & Pathfinding (NAV-01)
NavigationGrid&NavigationPath: 2D grid pathfinder supporting Manhattan and Euclidean heuristics, configurable diagonal movement, dynamic obstacles, and variable traversal costs.- Interactive Controls: Click anywhere on the map in Navigate mode to trace real-time A* waypoints avoiding water obstacles and stone walls.
6. Physics: Swept AABB & Knockback Motor (PHYS-02, PHYS-03, PHYS-04)
SweptAABB: Continuous swept collision detection eliminating high-speed entity and projectile tunneling through obstacle geometry.KnockbackMotor: Applies directional velocity impulses, deflects against wall surfaces along surface normals, and smoothly decelerates via friction decay.SpatialHashGrid: Dynamic spatial partitioning for fast broadphase proximity querying.
7. World Semantic Metadata & Elevation (WORLD-01)
WorldMetadataRegistry: Defines semantic tile properties, elevation strata (ground= 0,elevated= 1,flying= 2), and hazard zones (chasm pits).- Elevation Filtering: High-elevation bridges permit safe traversal over ground hazard abysses.
8. RPG Progression, Inventory & Loot (RPG-01, RPG-02)
LevelProgression: Mathematical XP curves, level thresholds, and attribute scaling (ATK,DEF,SPD).Inventory&EquipmentSystem: Dedicated equipment slots (mainHand,offHand,armor,accessory) modifying combat statistics upon equipping.LootTable: Weighted random drop generator.StatusEffectManager: Handles duration-based buffs and debuffs (Burning,Chilled,Regeneration) with periodic tick callbacks.
9. Audio Bus Routing System (AUDIO-01)
AudioBusSystem: Hierarchical routing network (master->music,sfx,ui) with cascading volume calculation, muting, and Web Audio synthesis.- Interactive Controls: Dedicated volume sliders and mute toggles with real-time composed gain output.
10. Reactive World Facts, Rules & Story Graph (CORE-03, STORY-01)
WorldFacts&TypedEventBus: Authoritative key-value fact store with hierarchical dot-notation and decoupled event emission.RuleEngine: Reactive condition-action listeners that mutate world state upon specific events (e.g. unlocking the bridge pass at Level 2).StoryGraph: Branching dialogue trees evaluating fact conditions and triggering narrative side-effects.
11. Versioned Save Engine (SAVE-01)
VersionedSaveEngine: Robust serialization pipeline with schema version headers, migration pipelines, and corrupt JSON diagnosis and repair.- Interactive Controls: Save and load live state snapshots, and test corruption error handling.
Running Locally
To launch the showcase demo in your local development environment:
npm run serve
Then navigate to http://localhost:8000/examples/showcase/ or http://localhost:8000/docs/demo.html.